replace in field
Type
command
Summary
Replaces text in a field container with other text with control over what happens to existing styling.
Syntax
replace <oldString> with <newString> in <fieldContainer> {preserving | replacing} styles
Description
Use the replace in field command to replace all instances of one string with another string in (part of) a field, with the choice as to whether styling is preserved or replaced.
If the preserving form is used, then the found strings will be replaced in the target field and the replacement text will take the same style as the first character in the found string.
If the replacing form is used, then the found strings will be replaced in the target field and the replacement text will have no style.
All styling outside of the instances of the pattern which are found is unaffected.
Parameters
| Name | Type | Description |
|---|---|---|
oldString | string | Any expression that evaluates to a string, and specifies the text to replace. |
newString | string | Any expression that evaluates to a string, and specifies the text to replace the oldString with. |
fieldContainer | A field chunk. |
Examples
replace "A" with "N" in field 1 preserving styles -- changes all As to Ns; the Ns will retain the styling of the As
replace "foo" with "bar" in char 1 to 3 of tFieldId replacing styles -- changes foo to bar in the given range of the field reference in tFieldId; the bars will have no styling.
Related
object: field
command: find, filter, replace
control structure: function
function: replaceText
glossary: command, regex pattern, container
Compatibility and Support
Introduced
LiveCode 8.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile